home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / PWAEBL11.ZIP / EBL.DOC < prev    next >
Text File  |  1995-05-11  |  6KB  |  128 lines
  1.  
  2. +-----------------------------------------------------------------------------+
  3. | Enhanced Bulletin Lister v1.1                                               |
  4. | Written by Drew [PWA]                                                       |
  5. | Docs Last Updated 04-27-95                                                  |
  6. +-----------------------------------------------------------------------------+
  7.  
  8.  
  9. +-----------------------------------------------------------------------------+
  10. | 0. Table of Contents                                                        |
  11. +-----------------------------------------------------------------------------+
  12.     1. Introduction
  13.     2. Packaging
  14.     3. Installation
  15.     4. Configuration
  16.     5. Last Words
  17.  
  18.  
  19. +-----------------------------------------------------------------------------+
  20. | 1. Introduction                                                             |
  21. +-----------------------------------------------------------------------------+
  22.     Refer to HISTORY.DOC for changes since previous versions.  Otherwise...
  23.  
  24.     Enhanced Bulletin Lister (EBL) is a simple and limited, but attractive
  25. lightbar and hotkey driven PPE to replace your "B" command while functioning
  26. as a seamless add-on to your existing defined bulletins.
  27.  
  28.     It is simple because unlike numerous other bulletin PPE's, you do not
  29. have to type in the pathnames of each and every bulletin you wish to have
  30. available to be shown for this PPE, since you may do so already (and have
  31. probably done so) in PCBSETUP.  It is limited because if the number of
  32. bulletins you have for a conference exceed one page in length, then the
  33. original method of the "B" command is used (no lightbars or hotkeys) for
  34. that conference.
  35.  
  36.     EBL is totally conference aware.  The only real configuration involved
  37. is defining your bulletins (in BLT.LST) and drawing your own bulletin menu
  38. files (BLT) in the normal fashion within PCBSETUP.  Hence, EBL is behaves
  39. more like an add-on to your existing bulletin setup.
  40.  
  41.     Source is also included, so feel free to improve upon this in any
  42. fashion.  Let me know (send me) if you make any worthwhile changes that
  43. should be included in future versions.
  44.  
  45.  
  46.  
  47. +-----------------------------------------------------------------------------+
  48. | 2. Packaging                                                                |
  49. +-----------------------------------------------------------------------------+
  50.     Your zip file should contain the following files:
  51.  
  52.         EBL.CFG        The main configuration file.
  53.         EBL.DOC        Documentation (you are reading it now).
  54.         EBL.PPE        The PPE itself.
  55.         EBL.PPS        Source code.
  56.         HISTORY.DOC    Revision history.
  57.         INSTALL.BAT    Installs STUFF.ME for PCBTEXT Prompts #224 and #611
  58.         SAMPLE.BLT     Sample BLT menu file for use with default config file.
  59.         STUFF.ME       Text file to replace Prompts #224 and #611
  60.         STUFF.PPE      Used in STUFF.ME
  61.         STUFF.PPS      Source for STUFF.PPE
  62.         OTHERDJP.DOC   Other stuff I've written.
  63.         FILE_ID.DIZ    File (zip) description.
  64.         PWA.NFO        PWA info file.
  65.         TSP.NFO        My bbs ad.
  66.  
  67.     If any of these files are missing, be warned that you may have a copy
  68. that has been tampered with.  If you have any extra files, they are
  69. extraneous and unnecessary.
  70.  
  71.     Typically, my bbs ad may not be there, which is not a problem.  However,
  72. the idiots who contribute this to the fidonet backbone (usually originating
  73. from the Clipper Workshop BBS) edit the FILE_ID.DIZ, remove PWA.NFO and
  74. OTHERDJP.DOC, and insert their own bbs ad which is bigger than most ppe's.
  75. Just be aware, since who knows what other stupidities they may pull.
  76.  
  77.  
  78.  
  79. +-----------------------------------------------------------------------------+
  80. | 3. Installation                                                             |
  81. +-----------------------------------------------------------------------------+
  82.     Add EBL.PPE to your CMD.LST as a replacement for the "B" command.
  83.  
  84.     Also, you will need to have PCBTEXT Prompts #224 and #611 point to the
  85. STUFF.ME text file.  Ie: "%C:\PPE\EBL\STUFF.ME".  If you wish, you may run
  86. INSTALL.BAT and have this part done semi-automatically.
  87.  
  88.  
  89. +-----------------------------------------------------------------------------+
  90. | 4. Configuration                                                            |
  91. +-----------------------------------------------------------------------------+
  92.     Assuming you have conferences defined with bulletins via PCBSETUP, you
  93. will need to edit EBL.CFG for configuration options.  Note that the same
  94. menu file (SAMPLE.BLT) is totally ficticious.  I have only included it so
  95. that you can see how the configuration file's information matches with this
  96. particular menu.  If you have really dull looking BLT menus, you might want
  97. to use the the sample one instead. :)
  98.  
  99.     Also, you will need to edit the file "STUFF.ME", and have the correct
  100. directory paths listed in there.
  101.  
  102.     Obviously, in all normal cases, it is up to you to draw your own BLT
  103. menu files and make sure the starting row and column positions for the
  104. lightbars is entered into the config file for that particular conference.
  105. You will also need to specify the BLT file as you would normally do inside
  106. of PCBSETUP for each particularconference.
  107.  
  108.  
  109.  
  110. +-----------------------------------------------------------------------------+
  111. | 5. Last Words                                                               |
  112. +-----------------------------------------------------------------------------+
  113.     The reason I made this PPE is because I lacked a bulletin ppe that was
  114. simple to configure.  I really dislike typing in bulletin names for each
  115. bulletin since that made it PPE specific (compared to just reading it from
  116. BLT.LST).  Also, PCBoard has a nice feature where it can automatically check
  117. and inform the user if any bulletins have been updated.  Most all other
  118. bulletin PPE's bypass this feature.  Lastly, it has a hotkey feature, so you
  119. can just "A" for first bulletin, "B" for the second, and so on.
  120.  
  121.     Otherwise, if you need to reach me for some reason, you can send internet
  122. email to "drew@xinet.com", or leave me a message on Attitude Net, or call my
  123. board: The Silicon Phalanx at 310-575-8567 and apply for access.
  124.  
  125. Peace,
  126. --Drew
  127.  
  128.